Overview

This section describes the available REST endpoints for searching real estate properties (Fast ejendom).

Generally, responses to searches are formatted in JSON. The found objects will typically be identified by a UUID, which can subsequently be used for lookups using the ejdsummarisk endpoint.

Endpoints

Søgning med adresse

Endpoint URL: ejendom/adresse

Method

GET

Description

Search for real estate using address information. Can be searched with or without floor and door/side.

Input

Query parameters (all optional):

  • husnummer

  • postnummer

  • vejnavn

  • etage

  • sidedoer

  • by

Content-Type

Requires application/json for both request and response.

Output

JSON response containing a list of matching properties (with uuid).

Error handling

Standard HTTP error codes for invalid input or lack of access.

Interaction pattern

Query response

Example request:

GET /ejendom/adresse?postnummer=4040&vejnavn=Venusvej&husnummer=1&etage=&sidedoer=&by=Jyllinge HTTP/1.1
host: nc-dev-xml-api.tinglysning.dk
accept: */*

Søgning med Bestemt Fast Ejendomsnummer (BFE-nr.)

Endpoint URL: ejendom/hovednoteringsnummer

Method

GET

Description

Search for real estate using the main registration number (BFE-no.).

Input

Query parameter (required):

  • hovednoteringsnummer

Output

JSON response containing the matching property.

Error handling

Standard HTTP error codes for invalid input or lack of access.

Interaction pattern

Query response

Example request:

GET /ejendom/hovednoteringsnummer?hovednoteringsnummer=2220333 HTTP/1.1
host: nc-dev-xml-api.tinglysning.dk
accept: */*

Søgning efter umatrikuleret areal

Endpoint URL: ejendom/uma/{uma}

Method

GET

Description

Search for real estate via an uncadastral area (UMA) identifier.

Input

Path parameter (required):

  • uma

Output

JSON response containing the matching property.

Error handling

Standard HTTP error codes for invalid input or lack of access.

Interaction pattern

Query response

Example request:

GET /ejendom/uma/21 HTTP/1.1
host: nc-dev-xml-api.tinglysning.dk
accept: */*

Søgning med landsejerlav og matrikelnummer

Endpoint URL: ejendom/landsejerlavmatrikel

Method

GET

Description

Search for real estate by specifying the cadastral district ID (landsejerlavid) and cadastral number (matrikelnr).

Input

Query parameters (required):

  • landsejerlavid

  • matrikelnr

Output

JSON response containing the matching property.

Error handling

Standard HTTP error codes for invalid input or lack of access.

Interaction pattern

Query response

Example request:

GET /ejendom/landsejerlavmatrikel?landsejerlavid=760353&matrikelnr=0039ac HTTP/1.1
host: nc-dev-xml-api.tinglysning.dk
accept: */*

EjendomSummarisk

Endpoint URL: ejdsummarisk/{uuid}

Method

GET

Description

Retrieve comprehensive property summary information using the property’s UUID. The response format can be controlled using optional query parameters.

Input

Path parameter:

  • uuid

Optional query parameters:

  • xhtml=true - returns response as XHTML

  • tmvXhtml=true - returns response as TMV XHTML

  • If neither provided, returns as OIO XML (default)

Output

Property summary data in the requested format (OIO XML, XHTML, or TMV XHTML).

The formatting of XHTML and TMV XHTML responses is not documented in detail and may change without notice.

Error handling

Standard HTTP error codes for invalid input or lack of access

Interaction pattern

Query response

Example request:

GET /ejendomsummarisk/cda5fd18-7366-4613-9395-f42f3c441389?xhtml=false&tmvxhtml=false HTTP/1.1
host: nc-dev-xml-api.tinglysning.dk
accept: */*

HistoriskAdkomst

Endpoint URL: ejdhistoriskadkomst/uuid/{uuid}

Method

GET

Description

Retrieve historical title information for a property using its UUID.

Input

Path parameter:

  • uuid

Output

JSON response containing historical title information for the property.

Error handling

Standard HTTP error codes for invalid input or lack of access.

Interaction pattern

Query response

Example request:

GET /ejdhistoriskadkomst/uuid/ba7eb3f4-18ba-43cd-b442-e791248e0a13 HTTP/1.1
host: nc-dev-xml-api.tinglysning.dk
accept: */*